home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / gfx_card / showgif.lha / ShowGIF.doc < prev    next >
Text File  |  1994-09-17  |  6KB  |  228 lines
  1.  
  2.  
  3.             =========================
  4.  
  5.                  ShowGIF V1.6
  6.  
  7.             =========================
  8.  
  9.  
  10.                 Sept. 11, 1994
  11.  
  12.  
  13.           Copyright (c) 1994 by Roman Hiestand
  14.  
  15.  
  16.  
  17.  
  18.  
  19. Copyright notice
  20. ----------------
  21.  
  22. The program ShowGIF and its documentation  are written and copyrighted by
  23. Roman Hiestand. They may be distributed freely providing the following
  24. restrictions are satisfied:
  25.  
  26. - Distributors may not charge more than the cost of a diskette used in
  27.   the distribution of this program.
  28.  
  29. - Distributors may only distribute the unmodified copy of the original
  30.   program, along with it's documentation, and copyright notices intact.
  31.  
  32. - Commercial  distribution  is  only  possible with written permission
  33.   from the author.
  34.  
  35.  
  36. Disclaimer
  37. ----------
  38.  
  39. This program and its documentation is provided "as is". No warranties are made
  40. with respect to the accuracy, reliability, performance or operation of this
  41. software and information. You are using this program at your own risk. The
  42. author is not liable for any damages that may have been caused by using this
  43. software.
  44.  
  45.  
  46.  
  47. Description
  48. -----------
  49.  
  50. ShowGIF is, as the name says, a GIF viewer for the Picasso-II graphics board
  51. of VillageTronic.
  52. The program can be started from CLI or Workbench with one or more file
  53. names/icons. If the program cannot load an image (because you didn't submit
  54. a filename or the file doesn't exist), a file requester pops up.
  55.  
  56.  
  57. Usage
  58. -----
  59.  
  60. From CLI: ShowGIF Image [...]
  61.  
  62.  Template: FILES/M,BUF/N,DELAY/N
  63.  
  64.  FILES/M: One or more filenames to be viewed
  65.           If no filenames are given or the files weren't GIFs, a
  66.       file-requester pops up.
  67.  BUF/N:   Specify the FileBufferSize in KB, like BUF 100
  68.  DELAY/N: Specifies the delay in seconds after showing the
  69.       picture. If none is given, the program waits for
  70.       a key or a mousebutton.
  71.       Remember: during this delay, the program can't be
  72.       stopped !
  73.  
  74.  Examples:
  75.  
  76.  ShowGIF BUF=5 SYS:Images/Globe.gif
  77.  
  78.  ShowGIF DF0:Pictures/Mercedes.gif DF0:Pictures/Family.GIF BUF 10 DELAY 5
  79.  
  80. From Workbench:
  81.  - Default Tool: Specify ShowGIF as the default tool of an image
  82.  - Multiple selection: With the shift-key pressed, select an image and
  83.    double-click on ShowGIF's icon.
  84.  
  85.  There are no arguments from the WB.
  86.  
  87.  
  88. Features
  89. --------
  90.  
  91. - fully programmed in assembler
  92. - uses a file buffer (50 KB by default)
  93. - CLI or WB start
  94. - very system-friendly
  95. - (nearly) pure
  96. - can be aborted at anytime (except during a crash ... :-) )
  97. - no 'light' background (since V1.1)
  98. - file requester (since V1.2)
  99. - FileBufSize can be specified (since V1.3)
  100. - supports entire GIF87a standard (local color maps, interlaced images,
  101.     multiple images, since V1.5)
  102. - supports partly GIF89a standard (comment/plain text extension)
  103.  
  104.  
  105. About being 'nearly' pure:
  106. You can safely make this program resident. You can run ShowGIF as many times
  107. as you want, if you run one *after* the other. A problem *can* arise when you
  108. run two or more ShowGIF's at the same time. The only part that is not pure is
  109. where it opens the screen and the window. This time is quite short, and it is
  110. very unlikely to happen that two ShowGIF's interfere. By the way, have you
  111. ever tried to view two images at the very same time ? (Not very useful, ay ?)
  112.  
  113.  
  114. Requirements
  115. ------------
  116.  
  117. Kick 2.0 and vilintuisup.library version > 2.0.
  118.  
  119.  
  120. Bugs
  121. ----
  122.  
  123. None known.
  124.  
  125. The problem is: I haven't got any GIFs with local colors, multiple images
  126. or plain text extensions. So I couldn't test it. I think, it works, but
  127. I'm not sure.
  128. If you find a bug, please report it to me together with as much information
  129. as possible that could help me to fix it: your computer, configuration, kick
  130. version and so on.
  131.  
  132.  
  133. Future plans
  134. ------------
  135.  
  136. - a bunch of options (Verbose ...)
  137. - pattern matching
  138. - view images larger than the largest screen available
  139. - reduce colors
  140. - faster ...
  141.  
  142.  
  143. Notes about this program
  144. ------------------------
  145.  
  146. The Graphics Interchange Format(c) is the Copyright property of CompuServe
  147. Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated.
  148. This program has been fully written in assembler. It is therefore very short
  149. and quite fast. The GIF decoding algorithm is mainly based on the c-source
  150. (jrdgif.c) of the jpeg software (version 4 of the jpeg software release),
  151. which itself is based on giftoppm. Many thanks to the JPEG group ! (Even if
  152. their real goal is to provide the JPEG-standard, not software for GIF :-) )
  153.  
  154. ShowGIF is pretty much optimised. Not only by the assembler (PhxAss is GREAT!
  155. Thanks to F. Wille), but also by hand. At this time, I can't think of another
  156. optimisation.
  157. When I compared ShowGIF to VT, I was pretty surprised because I didn't expect
  158. VT being so fast. Maybe I overlooked a couple of optimisations ...
  159.  
  160.  
  161.  
  162. Comparison table
  163. ----------------
  164. (Not representative)
  165.  
  166.  
  167.            ShowGIF V1.6      ViewGIF 1.6   VT_Picasso V2.1  ReadGIF V1.249
  168.                    from VillageTronic            (J.Weinelt)
  169.            ------------------------------------------------------------
  170.  
  171. Executable size        3176           19376         84584         12276
  172. display time (~,secs)      13          33            15            24
  173. Mem needed (~)         1.12 MB         1.18 MB       2.41 MB           1.17 MB
  174.  
  175.  
  176. Time & mem are measured with 'globe.gif' (547365 bytes, 912x900), a beautiful
  177. picture of the Venus from NASA. Program & image are on harddisk. The memory is
  178. measured including display memory.
  179.  
  180. These are just typical values. The differences in speed become smaller with
  181. smaller images and larger if the image is on ram-disk.
  182.  
  183.  
  184.  
  185. Revisions
  186. ---------
  187.  
  188.     1.0    -    first public release
  189.  
  190.     1.1    -    added support for interlaced images
  191.             now fills background with darkest color
  192.  
  193.     1.2    -    file requester added
  194.  
  195.     1.3    -    now checks for Ctrl-C (requested by Markus Illenseer)
  196.             corrected a bug in GetCode
  197.             added CLI-option BUF
  198.  
  199.     1.4    -    Multiple images supported
  200.             Output window for workbench
  201.             Faster ~10 %
  202.  
  203.     1.5    -    Doesn't quit anymore if GIF-revision is >89a
  204.             Supports Local color table
  205.             Correctly processes (skips) GIF89a extension blocks
  206.             CLI-option DELAY
  207.             some small optimisations
  208.  
  209.     1.6    -    Now supports some GIF89a extensions
  210.             even faster !
  211.  
  212.     1.61    -    Oops: forgot the titlebar in the file requester
  213.  
  214.  
  215. Address
  216. -------
  217.  
  218. I can be reached at
  219.  
  220. Roman Hiestand
  221. Luziaweg 15
  222. CH-8807 Freienbach
  223. Switzerland
  224.  
  225. Fax: CH-055/48 26 37
  226.  
  227. email: rhiestan@iiic.ethz.ch
  228.